Note: Please read this entire document as it contains lots of valuable info. However, for a quick overview of what's new in this version, please skip down to the "Version History" section near the bottom.
Contents
Introduction
What is Cinnamon WebMaster Suite?
How to use CWMS
Special Features
How much does Cinnamon WebMaster Suite cost?
About Cinnamon Computer Products
Licensing and Distribution Information
Future Additions
Compatibility
Known Problems & Issues
Version History
BugZappers Hall of Fame
Legal Information
Introduction
Thank you for downloading Cinnamon WebMaster Suite! This is the first product of Cinnamon Soft, a division of Cinnamon Computer Products. Cinnamon WebMaster Suite (CWMS) will eventually turn into a full-fledged commercial product, but for now it was originally intended for my own use. I have decided to release it as shareware in the meantime, because it is already a fully-functional and very useful product.
What is Cinnamon WebMaster Suite?
CWMS is a straightforward, yet very useful and useable, HTML editor. It is the perfect solution for Mac OS-based Web Page Design. It is compact, yet full of features.
Cinnamon WebMaster Suite was created to fulfill a need. WYSIWYG web page programs such as Adobe Pagemill just simply don't do the job. If I was going to have to write my own HTML, I needed a good editor--one that did more than a regular word processor, one that specifically helped me write web pages. It was out of this need that I created CWMS. It has all the capabilities of a simple text editor, with many special features dealing with HTML. As you read about and use Cinnamon WebMaster Suite, you will begin to discover these wonderful features. They hide well, but always ready to spring into action!
How to use CWMS
Using Cinnamon WebMaster Suite is quite easy. Everything is standard Mac OS. To open the program, you can double-click its icon or the icon of a document created by CWMS.
The Apple Menu
Ñ About Cinnamon WebMaster Suite
Displays information about CWMS
Ñ About Cinnamon Soft
Displays information about CCP
The File Menu
Ñ New
Creates a blank new document
Ñ Open╔
Open an existing document (Usually an HTML document, but you can open any TEXT file)
Ñ Close
Close the current document
Ñ Save
Save the current document (If untitled, will automatically function as Save As╔)
Ñ Save As╔
Saves the current document as a new document and switches to the new one
Ñ Export╔
Saves the current document as a new document without switching to the new one
Ñ Revert to saved
Reverts a document to its last saved form
Ñ Quit
Quits the program after closing all open documents
The Edit Menu
Ñ Undo
Undo does not function in this version of CWMS (see Future Additions, below)
Ñ Cut, Copy, Paste, Clear
The standard Mac OS clipboard commands
Ñ Select All
Selects the entire document
Ñ Show/Hide Find Controls
Shows or Hides the Find Controls for the active window
Ñ Find Next
Finds the next occurence of the search string - same as clicking 'Find' button
Ñ Replace & Find Next
Replaces the found text and finds next occurence - same as clicking 'Replace' button
Ñ Enter 'Find' String
Enters the selected text as the new search string
Ñ Insert Color╔
Using the Apple Color Picker, automatically formats and inserts the HTML color code
Ñ Insert Current Date
Betcha can't guess...
Ñ Insert Current Time
Another no-brainer...
Ñ Colorize Tags in Selection
Color-codes the tags & comments in the selected area of text
Ñ Capitalize Tags in Selection
Auto-Capitalizes the existing tags in the selected text, just like when you first type a tag
Ñ Update Comments
Cleans up improper COMMENTs from files created with earlier versions of CWMS (or for IE 2.0)
Ñ Preferences
Shows the Preferences dialog
The Text Menu
Ñ Monaco, Geneva, New York, System Font
Sets the font for the active document
Ñ 9, 10, 12, 14 point
Sets the font size for the active document
The Window Menu
Any open documents are displayed under this menu, in alphabetical order
Special Features
What makes Cinnamon WebMaster Suite useful are the HTML-specific features. Here is an explanation of all current features:
Ñ Color-coding
All text is color-coded for ease of reading. HTML tags are blue, comments are green,
quoted text inside tags is red, scripts are violet, and all normal text is black.
Ñ Automatic Capitalization of tags
It is customary to type HTML tags in all-caps, but it is very annoying to have to keep
switching Caps Lock on and off all the time. Go ahead and type tags in lowercase, and
CWMS will automatically convert each tag to uppercase when you type the ">" at the
end of the tag. Also, it is smart enough not to convert text which is in quotes.
Some common JavaScript keywords are now exempted from auto-caps. (See Version
History, below) If there are any others you use frequently, let me know.
Ñ ISO-Latin Key Filtering
CWMS will only allow you to type characters which can be represented in the standard
character set of the Internet. (see next item for related info)
Ñ Automatic Special Character Conversion
In Internet character sets, special characters are represented with embedded
shortcut values or phrases. For example, "ç" should be entered into a web page using
"á" or else the incorrect character will be displayed on Windows, UNIX, etc.
CWMS automatically converts special characters to their ISO codes. Type special
characters just as you normally would on a Macintosh. If nothing appears, you cannot
use that particular character on the Internet, although almost all characters can be.
Option-Space is a shortcut for the " " character phrase, which is used primarily
as a filler in blank lines or blank table cells to make them appear.
(the copyright symbol) and will delete the entire code phrase. This will only occur if
the cursor is immediately after the semicolon when you hit delete. If the cursor is
anywhere else, the delete key will function normally.
Ñ Smart Entry of Multi-Purpose Characters
There are several characters which, in addition to being part of regular text, are also
used within HTML commands. These characters include "<", ">", "&", and """. A simple
and powerful shortcut has been devised: The first time you type one of these
characters, it is assumed that you meant to use them for HTML code, and they appear
like normal. If you instead wanted the character-code to be inserted, all you have to
do is type the character again! Any time you type one of these characters a second
time in a row, the first one is automatically removed and replaced with the code!
Ñ Smart Comments maintain compatibility
Fixed at last!!!! You can use the shortcut "<!" to start a comment, and "/!" to end a comment. No more defunct <COMMENT></COMMENT> tags! No more problems! :) In fact, there's even a menu command now that will clean up those old comment tags automatically! See Update Comments, below...
Ñ "Insert Color" option
This shortcut command makes it easy to insert or modify HTML color hex codes. As of
v1.1.1, in order to further enhance the useability of Insert Color, it has been
significantly improved. The "#" symbol is now smart, i.e. it will automatically be
inserted at the beginning of the hex code only if there isn't already one there. Also,
by double-clicking the hex value of a preexisting color before choosing Insert Color,
the "old" color in the color picker will be the preexisting color. If no preexisting color
is selected, the last color that was inserted (into any document) is the default color.
Ñ "Colorize Tags in Selection" option
This option color-codes all the tags & comments in the selected area of text. Useful
for updating the colorization of tags which may have been uncolorized during editing.
The process can be stopped at any time with command-period.
Ñ "Capitalize Tags in Selection" option
Auto-capitalizes preexisting tags, just like when you type a new tag. Useful for existing documents.
Ñ Update Comments
Quickly and automatically removes all archaic <COMMENT> and </COMMENT> tags and replaces them with <!-- standard comments -->. It's even smart enough to avoid duplicates caused by a mixture of styles!
Ñ Find & Replace system
The Find & Replace system I've implemented in CWMS isn't done the standard way, and
I think you'll like it a lot. The Find Controls are built right into the document window.
They can be shown or hidden at any time, and you can choose the default status.
How much does Cinnamon WebMaster Suite cost?
Everyone: Cinnamon WebMaster Suite is $10.00 shareware.
Send in those Registrations! This program is being distributed on a shareware basis because it isn't ready to be sold commercially, but it's plenty good enough to be quite useful. By registering as a user of Cinnamon WebMaster Suite, you will gain several advantages:
Ñ Email notification of new versions or products
Ñ A clear conscience knowing that you're honest
Ñ Free updates between major versions
Ñ I will be encouraged to continue to expand CWMS
***** To register, please print and fill out the registration form found in the same folder as this document, and send it to:
Cinnamon Computer Products
Cinnamon Soft Division
410 W. Meadow Lane
Marshalltown, IA 50158-5113
If sending Cash, be sure to use a security envelope, and also wrap the cash inside the registration form. If sending check or money order, please make payable to Cinnamon Computer Products.
The most recent version of CWMS, can be downloaded from the Cinnamon Soft web site at:
http://members.aol.com/dustynk/cinnamonsoft
Registered users of CWMS only: If you paid $5.00 or more toward any previous version of CWMS, then please apply that amount toward the purchase price of this version. For example, if you paid the standard price of $5.00 for v1.3.1, then please send me another $5.00 to cover the remaining $5.00 of the new purchase price. Of course, if you feel that it's worth more, please send more. I'm much obliged! :)
About Cinnamon Computer Products
Cinnamon Computer Products is the trade name of Dusty Kothenbeutel, an interactive game and computer professional, and above all a futurist, living in Marshalltown, IA. Cinnamon Computer Products has two divisions:
Cinnamon Soft creates useful software for Mac OS-based computers. Cinnamon WebMaster Suite is the trademark product of Cinnamon Soft. Later on, Cinnamon Soft will become a major software developer for multiple platforms. Cinnamon GameSoft is a division of Cinnamon Soft, dedicated to producing cool new games for various platforms. Currently, our first simple game is out as freeware, known as SuperBike.
CinnaByte Internet Services provides high-quality Web Site Design, Web Site Hosting, and Dial-Up Internet Access. For more information, send email to dustynk@aol.com, or visit http://members.aol.com/dustynk/cinnabyte/, or write to the address above.
Licensing and Distribution Information
This version of Cinnamon WebMaster Suite is shareware, and may be freely distributed across the Internet, online services, and BBSs, as long as the entire software package (the Cinnamon WebMaster Suite application and all accompanying documents, most importantly "Read Me Please!" and "Registration Form", as well as the folder which contains them) is always included and not modified in any way.
You are permitted to use this software on a trial basis for a period of up to 30 days, at which time you must send in the completed registration form and $5.00 registration fee, or remove the program from your computer. Please send copies of the software package on to everyone you know.
Except for the following, the software package may not be included on or in any package or media which is to be sold, or distributed by means other than by modem, without prior written permission (an email response from dustynk@aol.com sufficiently qualifies as written permission) of Cinnamon Soft.
1) If you have obtained permission for any previous version of this software package, this permission is hereby extended to this version as well. (I would still appreciate being notified). However, this rule does not apply if you or the party you represent made payment to Cinnamon Computer Products or Dusty Kothenbeutel in order to secure the prior permission.
2) Permission to include this software package is hereby granted to you ahead of time, without a need to contact Cinnamon Computer Products or Dusty Kothenbeutel prior to the release of your package or product, if a complete complimentary copy of the entire package or product is sent to Cinnamon Computer Products at the above address.
3) Magazines which include a CD-ROM with each issue (such as MacAddict) need not ask permission at all in order to include CWMS, because in my opinion they aren't selling the CD, they're packaging it as part of the mag.
Contact Cinnamon Soft at the address above for details or to work out an agreement.
Future Additions
These are just a sampling of features and capabilities which are being planned for addition to future versions of Cinnamon WebMaster Suite:
Ñ Totally rewritten in C for speed and capability gains
Ñ Option to capitalize all preexisting tags in a document
Ñ Ability to easily create plain text documents as well as HTML documents
Ñ Menu/Command-key shortcuts for commonly used tags
Ñ FKey shortcuts for commonly used tags
Ñ Print routine
Ñ Ability to Undo
Ñ Shortcut for automatically entering end tags (such as </BODY> or </COMMENT>)
Ñ User-definable shortcuts
Ñ and many more!
Compatibility
Cinnamon WebMaster Suite has been tested on, and is thought to be fully-functional under, Mac OS versions 7 through 8.6. The program is extremely non-volatile, but, regardless of what computer model or system version you have, no guarantees are made that this software will function appropriately or at all. You use this software at your own risk. No responsibility or liability on the part of Cinnamon Computer Products shall exist.
If you do have any problems of any sort, please report them to me at dustynk@aol.com, or at the address above. I am very grateful for the reporting of any weaknesses or flaws in this software. Please include a detailed summary including a description of what happened, what you were trying to do, your computer model and configuration, any errors or messages you received, what system software you were using, etc. I may be able to suggest an immediate solution, or work one into the next version.
Known Problems & Issues
***** A current listing of known bugs & issues, if any, will be posted on the *****
***** Cinnamon Soft site at http://members.aol.com/dustynk/cinnamonsoft/ *****
Ñ Why do document windows no longer have close boxes? Alas, the v1.x incarnation of CWMS is written in FutureBASIC, which in addition to being outdated is beginning to exhibit many strange and buggy behaviors. Many of these quirks I've come across before, and have worked around as best I can. However, while I was creating v1.3, the size of the program increased quite significantly, and lots of new and puzzling things have begun happening. First and foremost, I discovered that, if any documents had been closed at any time during the session, the program would not quit, no matter what. I still cannot explain this phenomenon, and the only way I managed to get it to quit was to manually make it quit right in the middle of the program. After I released v1.3, it was discovered that clicking the close box - saving worked fine, but then after the routine was completely done, the app unexpectedly quits. Why? I have no explanation. CWMS handles the menu option and the close box exactly the same way (calls a function named CloseDoc). Further, I have verified that it works both ways, and only after the routine is finished, exited, and nothing is happening, FutureBASIC itself crashes. I tried using different types of windows, (such as without the zoom box) but they changed it to major system crashes instead of unexpected quits. So, the only solution was for me to remove the close box from all the document windows. I am very sorry I had to resort to this, but keep in mind that it's not a bug in my code, it's in the programming environment itself. Now, I know there's not an acceptable excuse for poor software, no matter whose fault -- all I can say is that it will be alleviated when I finish CWMS v2.x, which is being completely rewritten in CodeWarrior.
Ñ Only two people have ever reported a complete inability to get CWMS to work, and both of them have Power Mac 7100s. If you have any problems, especially with a 7100, please let me know. I haven't been able to find any reason yet.
Ñ Several of you have reported a miscolorization bug while typing text immediately after a tag. However, this is not a bug in CWMS. It is an unfortunate side effect which is generated intentionally by the Mac OS. Specifically, the built-in Mac OS text services, known as TextEdit, always apply the same formatting to a typed character as the character immediately before it. This is desirable in nearly all programs, namely word processors. In CWMS, it happens to be a bit undesirable at times. I have worked around it when you are typing text right in a row. But if you use the mouse to place the cursor in a different position, the miscolorization will occur. Unfortunately, there is currently nothing I can do about it because the System does it from beyond CWMS's knowledge or control. I will have resolved the issue by the time version 2.0 is released, because I am writing a custom application environment for the next incarnation of CWMS. In the meantime, this is the reason why I made the "Colorize tags" into a menu option, so that you can clean up the colors any time you want to.
Ñ Choosing Cut, Paste, or Clear from the menu does not register as a change to an unchanged document. FutureBASIC handles the Edit Menu itself and won't allow CWMS to "see" them. (I bet you wouldn't have even noticed this one!) This will be corrected when CWMS is rewritten in C. Workaround #1: Using the command-key shortcuts for Cut or Paste will register as a change. Workaround #2: Make a simple change and undo it.
Ñ Undo is greyed out, because it hasn't been programmed yet
Version History
Ñ 1.0 - January 30, 1998
* This is the initial release.
Ñ 1.1 - February 8, 1998
* Added "Insert Color" feature under Edit Menu
* Added "</!" as a shortcut for "</COMMENT" as an addition to Smart Comments
* Corrected a problem where "Save" and "Revert" were not activated/deactivated when switching between documents
* Corrected a minor colorization problem with one variety of Smart Comments
Ñ 1.1.1 - February 16,1998
* Windows will now behave properly when resized
* "Insert Color" now registers as a change to the document
* "Insert Color" is totally revamped to increase functionality and ease of use:
* The "#" sign only gets inserted if it's not already there
* Selecting a preexisting hex color code before choosing Insert Color will use the preexisting color as the default in the color picker
* If no preexisting hex code is selected, the last color to be inserted is the default
* The information in the "About Cinnamon Computer Products" window was updated to reflect the address of Cinnamon Soft's new website
* Added new icons. Big thanks to Eric Ward (ericward@xmission.com), they're great! Note: If the icons don't change, you'll need to rebuild your desktop.
Ñ 1.1.2 - February 26, 1998
* Added "Colorize Tags in Selection" option under Edit menu. Color-codes all the tags & comments in the selected text, just like it says. 8-) This is done automatically when a document is first opened, but after editing, there can be tags left uncolored.
* The Colorization process can now be cancelled at any time during the process. The current incarnation of the Colorize routine is very slow on large files--for example, on my computer it takes over 25 minutes to open this Read Me file. In actuality, it takes less than half a second to load the file, and 25 minutes to colorize it, so I added the command-period abort routine to save time and eliminate hassle. You can always use the new Colorize option on selected parts of the file later.
* You can now make selections using shift-arrow keys. It has some bugs, but it'll do until I can learn how to implement the Macintosh Drag Manager properly.
* Removed the ellipsis from the "New" option under the File menu. Once I implement some other file types, it will return and be proper. (Thanks to Scott Knick for noticing that one)
Ñ 1.1.3 - March 2, 1998
* Corrected a bug where a '!' anywhere in a tag would cause it to be comment-colored instead of tag-colored (reported by Scott Knick)
* Corrected a bug where typing a '!' did not register as a change to the document
* Includes several new files: An AutoTyper to convert TEXT files to have a CWMS creator type, and a small icon to be included on web pages created with CWMS with a link back to the Cinnamon Soft website.
Ñ 1.2 - March 17, 1998
* The following JavaScript keywords are now exempted from Auto-capitalization for aesthetic reasons: onClick, onFocus, onBlur, onChange, onMouseOver, onMouseOut, onSelect, onSubmit, onReset
* Added an Insert Date option under the Edit menu
* Added an Insert Time option under the Edit menu
* Added a new "Made with CWMS" graphic, courtesy of Oliver Mandic
Ñ 1.2.1 - April 7, 1998
* Smart Comments have gained another IQ point. It is common for JavaScript users to use an old-style comment (<!-- -->) around the code to hide it from non-Java-capable browsers. Smart Comments will now differentiate between a regular comment and one following a <SCRIPT> tag, and will not convert the old-style tag into a new-style one. (Thanks to Scott Knick for reporting the problem)
* Fixed a small bug with the Colorize tags option, which failed to colorize plain text
Ñ 1.2.2 - April 27, 1998
* Added a new Smart Delete feature -- CWMS will now recognize a special character code phrase such as " " and will delete the entire phrase if the cursor is just behind the semicolon when you hit delete. (Thanks to Romain for the suggestion)
* Added a new shortcut -- Option-Space will now insert the " " code phrase, which is used for filling a blank space into <P> tags and table cells.
Ñ 1.2.3 - May 11, 1998
* The missing character code for the à character has been added. (First reported by Frogoff Ataka)
* The routine that handles the ! key has been revamped. Now ! is the shortcut for the word COMMENT. CWMS will still automatically convert to mixed-style comments, just type the ! key a second time.
Ñ 1.2.4 - May 26, 1998
* I discovered and corrected a bug which prevented an '!' from being typed after any 't'.
* I finally figured out a way to colorize quoted text inside tags. It will appear red.
Ñ 1.3 - June 17, 1998
* Added choice of Font and Size for each document
* Added Zoom Boxes to documents
* Added full-featured Find & Replace system
* Added number-key shortcuts to Window Menu
* Documents remember Font and Size
* Documents remember Window Size and Position
* Documents remember text selection
* Improved default window size for monitors larger than 640x480
* Added Preferences feature. The program remembers:
* Default Font & Size
* Whether to Colorize documents by default
* Whether to show Find Controls by default
* Corrected a bug which caused a system crash if opening or saving a zero-length file (reported by R. Lambert)
* CWMS now actually requires System 7 or higher. This is to prevent bugs, and I seriously doubt anyone out there has System 6 anyway!
* Menu commands relating to the currently-selected text now activate/deactivate in response to the selected text
Ñ 1.3.1 - June 21, 1998
* Close boxes have been removed from all document windows because of a serious and unfixable bug in the FutureBASIC programming environment. The menu command and keyboard shortcut still works fine to close documents. The boxes will not return in v1.x until such time as they would spontaneously begin working again. This seems very confusing, and believe me I'm more confused than anyone. For full details, see the "Known Problems & Issues" section above.
* Clicking the zoom box now zooms a document window to fill the screen on all monitor sizes. The default size is still no larger than 640x480.
Ñ 1.4 - September 30, 1999
* Fixed several bugs with the Windows Menu when closing documents.
* Removed all references to the tags "<COMMENT>" and "</COMMENT>". Originally, it was my understanding (from an HTML book) that these were new tags, designed to replace the "<!-- this is a comment -->" form. But after greatly increasing my knowledge of HTML, I have discovered that this book was mistaken, and it has caused problems for many users. I apologize, and comments have now been completely fixed!
* Improved handling of Scripts. They should be easier to work with now. Also, CWMS now deactivates both its HTML and ISO-Latin typing shortcuts between <SCRIPT> and </SCRIPT>, significantly improving the ease of typing scripts.
* Completely rewritten Colorization routine. Scripts and Comments are now both recognized much more consistently.
* Added an Update Comments feature, which automatically removes <COMMENT> and </COMMENT> tags and replaces them with proper <!-- comments -->
* Added Control-Return as a shortcut for <P> tag
* Added Option-Return as a shortcut for a <BR> tag followed by a return
* Added "/!" as shortcut for "-->"
* Added a Capitalize Tags in Selection command.
* Added a fourth Font option: System Font. This will be whatever your System Font is (Chicago on System 7; Charcoal on System 8.1; or any number of choices on System 8.5) For 8.5 users, I highly recommend Sand ;)
* Various minor visual-layout improvements throughout the program, to allow extra space for various System Fonts.
* Fixed page-size bugs with the Page Up and Page Down buttons while Find Controls are showing.
* Inset the default window size by 3 pixels all around
BugZappers Hall of Fame
Here's your chance to be famous! Send in a bug report, and get your name in the Hall of Fame! Only new and unknown bugs count. Ties are listed in alphabetical order.
1) "The King Of Bugs" Scott Knick - 4 bugs
2) Frogoff Ataka - 1 bug
R. Lambert
Legal Information
All products, names, and companies mentioned in this document are the trademarks, registered trademarks, or other property of their respective companies.
⌐1998-1999 Cinnamon Computer Products. All Rights Reserved.
